跳到主要内容
中文系列课

属性（Props）

新版 Runtime（推荐）​

RiveView 常用属性：

  • file（必填，RiveFile）：要渲染的文件
  • hybridRef：来自 useRive 的 ref setter
  • autoPlay（默认 true）：是否自动播放状态机
  • fit（默认 Contain）：适配方式
  • alignment（默认 Center）：对齐方式（Fit.Layout 下忽略）
  • layoutScaleFactor（默认 -1）：Fit.Layout 的缩放系数
  • artboardName：指定 artboard
  • stateMachineName：指定 state machine
  • dataBind：数据绑定模式或实例
    • DataBindMode.Auto（默认）
    • DataBindMode.None
    • { byName: string }
    • ViewModelInstance
  • onError：错误回调 (error: RiveError) => void

数据绑定详见：

Legacy Runtime​

Legacy <Rive /> 常见属性：

  • 文件来源：resourceName / url / source
  • 播放控制：autoplay、animationName、stateMachineName
  • 布局：fit、alignment、style
  • 回调：onPlay、onPause、onStop、onLoopEnd、onStateChanged、onError
  • 事件：onRiveEventReceived

说明：Legacy 仍可用，但建议迁移到新版。